home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / util / text / txt-wnd_.lha / English / Text-Wandler.DOC < prev    next >
Text File  |  1995-10-03  |  24KB  |  689 lines
  1.  
  2.  
  3.                Text-Wandler V3.9
  4.              <><><><><><X><><><><>
  5.                © 1992-1995 by Kai Seidel
  6.  
  7.  
  8. Introduction:
  9. *************
  10.  
  11. Beside my Amiga, I have a PC for the work with my mailbox programs & texts.
  12. Therefore  it  is  annoying  that the Amiga ASCII-table does not correspond
  13. with  the  IBM-table.The  texts of the Amiga are (almost) not readable on a
  14. MS-DOS  compatible.   For  that reason, I decided to write a text converter
  15. which  converts  the texts between both of the ASCII-formats.  Equally, the
  16. different  end  of  the lines between PC and Amiga is a problem.  The Amiga
  17. uses a $0a (=linefeed) and the PC a $0d0a (=carriage return + linefeed) for
  18. the end of line.
  19.  
  20.  
  21. The Program:
  22. ************
  23.  
  24. My  program solves this problem.  It is completely written in assembler and
  25. consequently  uses  the  FULL  speed of the computer.  There will always be
  26. loaded  16KByte (=16384 Bytes) from the text file which is to be converted,
  27. translated  and saved under the new name again.  However, there will not be
  28. only  allocated  16KByte  memory by the program.  Approximately 80 KByte of
  29. RAM-storage  should  be free altogether.  (Almost?) Every typing error will
  30. be caught.
  31. In  order  to  attain  a  rather high speed, 8 routines separated from each
  32. other  were  integrated,  two  for  the  conversion of texts between PC and
  33. Amiga, another two for the conversion of texts between Amiga and Atari, one
  34. for the conversion into normal ASCII-characters (Ä=Ae), one for the removal
  35. of  unused  spaces  and  tabs,  one  for  the removal of inconvenient ANSI-
  36. sequences  and  one for the use of an own conversion table.  Three complete
  37. ASCII-tables  which  make  it  possible without problems to translate other
  38. characters like >ÄÖÜäöoß< as well are also included in the program.
  39. The program possesses a STARTUP-code for the version 2.0 and higher.  Since
  40. that it can be used from both the CLI/SHELL and the Workbench!
  41.  
  42. The program converts since version 1.4 the following special characters:
  43.  
  44.    ÄÖÜäöüߢ£¡¤¥§ª«¬­°±²µ¶º»¼½¿ÅÆÇÉÑàáâåæçèéêëìíîïñòóôøúûÿ
  45.  
  46. Those  characters  are transferred correctly in both conversion-directions.
  47. Unfortunately,  these  are the only special characters, which are available
  48. in both, the MS-DOS- and the AMIGA-ASCII-table.
  49.  
  50. During the process of converting, the current position of the text-position
  51. is displayed.
  52.  
  53.  
  54. System requirements:
  55. ********************
  56.  
  57. Actually  none.   The  text-converter  should  be  able  to  run with every
  58. configuration.  One requirement is certainly kickstart 1.2 or higher!
  59.  
  60. Kickstart/WB 2.x (Intuition/Gadtools V37 or higher):
  61.   >ASL.LIBRARY< is required for the file requester.  These MUST be found in
  62.   the "LIBS:" directory of the boot disk.
  63.  
  64. Kickstart/WB 1.2/1.3:
  65.  
  66.   >REQ.LIBRARY<  is required for the file requester.  If it is not found in
  67.   the  LIBS:   directory,  you  should  look on the fish-disks.  Before the
  68.   start,  this  library  must  be  copied  into the LIBS:  directory of the
  69.   workbench disk or the boot partition!
  70.  
  71.  
  72. Installation:
  73. *************
  74.  
  75. Copy the files 
  76.  
  77.      Text-Wandler
  78.  and Text-Wandler.info
  79.   
  80. into any directory and start the program from CLI/SHELL or Workbench.
  81.  
  82.  
  83. WORKBENCH-Start:
  84. ****************
  85.  
  86. By  clicking  the  text-converter-icon  twice, you start the text-converter
  87. with the intuition-interface (in Workbench-mode).
  88.  
  89. According  to  your  kickstart/workbench  version, the text-converter opens
  90. different screens and windows.
  91.  
  92. The use under kickstart/workbench 1.2/1.3:
  93. ******************************************
  94.  
  95. The shareware-version opens an info-window at first.  The window disappears
  96. by clicking its CLOSE-Gadget (=Close-lever) once.
  97. Now the actual text-converter window appears with the following gadgets:
  98.  
  99.  - Get Source
  100.  
  101.    If  you  click  on  this  gadget,  the file requester of the Req.library
  102.    opens.  Now, with its help, you can choose comfortably by mouse the text
  103.    that is to be converted.
  104.  
  105.  - Gadget right of >Get Source<
  106.  
  107.    This  is  a  so called string-gadget.  If you choosed the text-data with
  108.    the  help  of  the  file  requester, the complete file name and the path
  109.    appears  here.  You can also use your keyboard by clicking on the gadget
  110.    and type in the name of the file directly.
  111.  
  112.  - Get Destination
  113.  
  114.    Here you can choose again the data name of the completely converted file
  115.    with the help of the file requester.
  116.  
  117.  - Gadget right of >Get Destination<
  118.  
  119.    Here  again  the  appertaining  string-gadget for the target-data-name +
  120.    path
  121.  
  122.  - Get trans table
  123.  
  124.    If  this  gadget  is  clicked,  the  file  requester of the Req.library.
  125.    opens.  With its help, you choose the conversion-table (more information
  126.    will be given later).
  127.  
  128.  - Gadget right of >Get trans table<
  129.  
  130.    Here again the appertaining string-gadget for the table-name with path
  131.  
  132.  - Gadget right of >Mode<
  133.  
  134.    Here you can choose the mode to convert the text with.
  135.  
  136.  - OK and STOP
  137.  
  138.    When  source,  destination  text  and table is defined you can start the
  139.    conversion by clicking this gadget.  While converting the OK-gadget will
  140.    change  into  STOP.  You finally can stop the conversion by clicking the
  141.    STOP-gadget.
  142.  
  143. Next to >Position:< the actual converting-position will be displayed.
  144.  
  145. If errors occur they will be shown at >Status<.
  146.  
  147.  
  148. The use under Kickstart/Workbench 2.x
  149. *************************************
  150. The  Text-Wandler  opens an own screen by using the actual screenmode and a
  151. window  in  which  the  gadgets and file requesters will be displayed.  The
  152. shareware-version first opens an info-window.  This window can be closed by
  153. clicking the "CONTINUE" gadget.
  154.  
  155. The window consists of the following gadgets:
  156.  
  157.  - Select Source (hotkey 'S')
  158.  
  159.    By  clicking  this  gadget  a req.library file requester will be opened.
  160.    Now you can choose the text to be converted.
  161.  
  162.  - Gadget under >Sourcefile< (hotkey 'O')
  163.  
  164.    This  is  a string-gadget.  If you choose the text by the file requester
  165.    the  filename  with  the  path will be displayed.  You can also type the
  166.    name  of the textfile into this gadget without using the file requester.
  167.    The cursor appears if you click on it.
  168.  
  169.  - Select Destination (hotkey 'D')
  170.  
  171.    Here  you  can  choose  the  destination  filename  by  using  the  file
  172.    requester.
  173.  
  174.  - Gadget under >Destinationfile< (hotkey 'E')
  175.  
  176.    The  filename  of  the destination file will be shown and can be fitted.
  177.    The source text will be converted later to this filename.
  178.  
  179.  - Select Table (hotkey 'T')
  180.  
  181.    Is  this  gadget  clicked, a file requester appears and asks you for the
  182.    filename of the table.
  183.  
  184.  - Gadget under >Translation Table< (hotkey 'R')
  185.  
  186.    Here again the string-gadget for the filename.
  187.    If  Mode  isn't  'Use translation table', this gadget and the gadget for
  188.    choosing files by the filerequester will be disabled.
  189.  
  190.  - Gadget under >Mode< (hotkey 'M')
  191.  
  192.    Here you can choose the mode to convert the text with.
  193.  
  194.  - Start/Stop (hotkey 'A')
  195.  
  196.    When  source,  destination and table filenames are fitted, you can start
  197.    the  conversion  by clicking this gadget.  While operating you can abort
  198.    the conversion by clicking this gadget again.
  199.  
  200. You can select gadgets by using their hotkeys!
  201.  
  202. Next to >Position:< the actual text-position will be displayed.
  203.  
  204. Are there any errors, a message will be displayed at >Status<.
  205.  
  206. To  quit  the  program  click on the close-gadget.  The settings like mode,
  207. file-paths  &  names  will  be  stored  in the ENV:-path.  The created file
  208. called  "tw.tmp"  will  be  reloaded when beeing started next time.  If you
  209. make a reset to the computer, the settings will be lost, too.
  210. To  provide  that the settings-file will be deleted, copy the file from the
  211. ENV:-path to the ENVARC:-path.
  212.  
  213.  
  214.  
  215. CLI/SHELL-Usage:
  216. ****************
  217.  
  218. Text-Wandler [-i/-a/-m/-t/-s/-c/-u/-r/-z]
  219.          [-o] [-n] <sourcefile> <destfile> [table]
  220.  
  221. <> arguments
  222. [] options
  223.  
  224.  
  225. Arguments:
  226. **********
  227.  
  228. The arguments <sourcefile> and <destfile> MUST be given or an error message
  229. will  be  the  result.  The sequence of giving the filenames must be right,
  230. too.
  231.  
  232. When  there  are spaces in the filename they must be set in quotation marks
  233. (see examples later).
  234.  
  235. Additionally  to  that,  instead  of giving a destination filename, you can
  236. declare  a path, in which the source file will be converted with the source
  237. filename.
  238.  
  239. Options:
  240. ********
  241.  
  242. Only one of the following nine options can be choosed:
  243.  
  244.  -i  The  text  is  given in Amiga-ASCII-format and is to be converted into
  245.      MS-DOS-ASCII-format which includes special character conversion.
  246.  
  247.  -a  The  text  is given in MS-DOS-ASCII-format and is to be converted into
  248.      Amiga-ASCII-format.
  249.  
  250.  -t  The  text  is  given in Amiga-ASCII-format and is to be converted into
  251.      Atari-ST-ASCII-format.
  252.  
  253.  -m  The text is given in Atari-ST-ASCII-format and is to be converted into
  254.      Amiga-ASCII-format.
  255.  
  256.  -s  The  text  is  either  given  in  Amiga-  or MS-DOS-ASCII-format.  All
  257.      unnecessary spaces or tabs at the end of lines will be deleted (take a
  258.      look at the limitation of the shareware Version).
  259.  
  260.  -c  Vowels  i.e.   "ÄÖÜ",  will  be translated into usual ASCII-characters
  261.      "AeOeUe".
  262.  
  263.  -u  The  Text-Wandler  uses  the  Workbench-Mode.   That means a window is
  264.      opened in which several options can be chosen by mouse.
  265.  
  266.  -r  ANSI-Sequences will be deleted out of Amiga-texts by that.
  267.  
  268.  -z  Uses  an  own  table for conversion.  If you use this option, you MUST
  269.      give  a  third filename refering the translation table (take a look at
  270.      the limitation of the shareware Version).
  271.  
  272. If  none  of  the  listed  options  is  chosen,  the  text is automatically
  273. converted into MS-DOS-ASCII-format.
  274.  
  275. The last two options can be given if necessary:
  276.  
  277.  -o  If  the destination filename already exists, this option will cause no
  278.      security check whether the file should be erased.
  279.  
  280.  -n  Turns  off  the  display of the current text-position while converting
  281.      (saves time).
  282.  
  283.  
  284. Examples:
  285. *********
  286.  
  287. For illustration some examples:
  288.  
  289. 1.   Text on disk in DF0:  named "Test.txt" is in Amiga-ASCII-format and is
  290.      to  be  converted  into MS-DOS-ASCII-format.  The converted text shall
  291.      get  the  name  "Hello.txt"  and  be  laid  into  RAM:.  Therefore the
  292.      following usage is necessary:
  293.  
  294.       Text-Wandler -i DF0:Test.txt RAM:Hello.txt
  295.  
  296. 2.   Text  on harddisk DH0:  named "Happy Day.txt" is in Amiga-ASCII-format
  297.      and  is to be converted into MS-DOS-Format on Disk DF2:  with the same
  298.      name.
  299.  
  300.       Text-Wandler -i "DH0:Happy Day.txt" DF2:
  301.  
  302. 3.   Text  on Disk in PC0:  named "Read.txt" is in MS-DOS-Format and is to
  303.      be  converted into AMIGA-Format on harddisk WORK:  with the name "Read
  304.      Me.txt".   A possibly existing file with the same name ("Read Me.txt")
  305.      may be deleted.
  306.  
  307.       Text-Wandler -a-o PC0:Read.txt "WORK:Read Me.txt"
  308.  
  309. 4.   Text  on RAM:  named "Temp.txt" in Amiga- or MS-DOS-ASCII-format.  The
  310.      text  was  just  edited  and  any  existing  spaces  or tabs should be
  311.      deleted.   The  converted  file  shall  be named "RAM:Ready.txt".  For
  312.      speed   up,  the  display  of  the  current  text-position  should  be
  313.      suppressed.
  314.  
  315.       Text-Wandler -s-n RAM:Temp.txt RAM:Ready.txt
  316.  
  317. 5.   Text    on   disk   DF2:    named   "Text-Wandler.DOC"  in  Amiga-  or
  318.      MS-DOS-ASCII-format  possesses vowels.  Those should be converted into
  319.      normal characters to disk in DF1:  named "TXTWND.DOC".
  320.  
  321.       Text-Wandler -c DF2:Text-Wandler.DOC DF1:TXTWND.DOC
  322.  
  323. 6.   You wish to start the Text-Wandler in workbench mode.
  324.  
  325.       Text-Wandler -u
  326.  
  327. 7.   A capture-file (e.g. from JRComm) consists of annoying ANSI-sequences,
  328.      which  are  to  be  deleted.   The file is named "DF1:Example.CAP" and
  329.      shall be converted to RAM:
  330.  
  331.       Text-Wandler -r DF1:Example.CAP RAM:
  332.  
  333. 8.   A text shall be converted by an own defined table.  The table is named
  334.      "t:Tab.tab".  The text to be converted is on RAM:  and named "Hello Mr
  335.      XYZ".    The   converted   text   shall   be  on  T:   with  the  name
  336.      "Happy_Day.txt".
  337.  
  338.       Text-Wandler -z "RAM:Hello Mr XYZ" T:Happy_Day.TXT t:Tab.tab
  339.  
  340.  
  341. The conversion Table:
  342. *********************
  343.  
  344. Here  it  is  -  the  Text-Wandler  version,  many  people have waited for!
  345. Version  3.0  and  higher, now the Text-Wandler converts your texts by your
  346. own will.
  347.  
  348. The  CLI-option  "-z" and the conversion-mode "Use conversion table" need a
  349. so called translation-table.  This has got the following structure:
  350.  
  351. "abc"="def"; /* converts "abc" to "def" */
  352. 34,"Hello",34="Hi"; // "Hello" is converted into "Hi"
  353. $0a=$0d,$0a; /* The Amiga-Linefeed will be replaced by
  354.         a MS-DOS carriage return and linefeed */
  355. .....
  356. .
  357. .
  358. etc.
  359.  
  360. There  may be strings, hex- and decimal-numbers given.  Strings must be set
  361. in quotation marks and hex-numbers need a "$" before the number is given.
  362.  
  363. The "=" character divides the sequence that shall be converted.  At the end
  364. of a declaration a semicolon ";" is needed.
  365.  
  366. Comments  are also possible.  Either normal C or C++ comments may be given.
  367. Normal  C  comments  begin with "/*" and end with "*/".  C++ comments begin
  368. with "//" and end with the end of a line.
  369.  
  370. For better understanding some examples:
  371.  
  372. - The  character  "a"  shall  be  converted  to  an  "A".   Therefore  more
  373.   combinations can be given:
  374.  
  375.   $61=$41;
  376.      or
  377.   "a"="A";
  378.      or
  379.   97=$41;
  380.     etc.
  381.  
  382. - The characters "-" and "+" shall be exchanged:
  383.  
  384.   $2B=$2D;
  385.   $2D=$2B;
  386.      or
  387.   "-"="+";
  388.   "+"="-";
  389.     ect.
  390.  
  391. - All spaces shall be replaced by a "_":
  392.  
  393.   $20=$5f;
  394.      or
  395.   32="_";
  396.  
  397. - Every "!" shall be deleted:
  398.  
  399.   "!"=;
  400.  
  401. You can generate your own ASCII-character set!
  402.  
  403.  
  404. Error messages:
  405. ***************
  406.  
  407. For the following problems/errors there are messages:
  408.  
  409. - No input is given
  410. - Wrong/No option(s) is(/are) given
  411. - No filename or none given
  412. - Source- or destination-filename are equal *)
  413. - Source-file does not exist
  414. - Destination-file already exists
  415. - Destination-path not allowed
  416. - Not enough free memory
  417. - Error while reading/writing from/to source-/destination-file
  418. - Incorrect line in table will be displayed
  419.  
  420. Attention !!! The marked "*)" error messages will be ignored by
  421. using the Workbench-mode!
  422.  
  423.  
  424. Hints for converting:
  425. *********************
  426.  
  427. If  you  convert  large  texts,  it  will be expedient to copy them to RAM,
  428. because the text will be read faster from RAM than from disk or harddisk.
  429.  
  430. All  switches  can be set on any position.  Only the succession of source-,
  431. destination- and table-filename must be given !
  432.  
  433.  
  434. Known bugs:
  435. ***********
  436.  
  437. None! Most bugs always appear if you don't need them!
  438.  
  439. I always try to remove bugs if they get known.
  440.  
  441. If you find a bug, please let me know!
  442.  
  443.  
  444. Important information:
  445. **********************
  446.  
  447. There  is  neither  a  guarantee  for  the  100% working capability of this
  448. program  nor  does  the programmer take any responsibility for consequences
  449. that result of wrong commands or the general usage of the program.  You use
  450. this software on your own risk.
  451.  
  452. Only use ASCII-text-files, or crashes can be the result.
  453.  
  454.  
  455. If errors appear:
  456. *****************
  457.  
  458. Please send a message with a complete error-report to the following address:
  459.  
  460. Kai Seidel
  461. Traunsteiner Str. 19
  462. 83355 Grabenstaett
  463. GERMANY
  464.  
  465. or via EMail: +49 (0)8661-8104 (24h online; 1200-33600 baud)
  466.  
  467. Or if even you have ideas to be installed into Text-Wandler write to that
  468. address!
  469.  
  470. I'm also reachable via Zerberus-Net: SYSOP@CHIEMGAU.zer.sub.org or
  471.                        INTERNET    : mail061@fh-rosenheim.de
  472.  
  473. Restrictions of the shareware version:
  474. **************************************
  475.  
  476. The  space  and tab deleting routine only can convert Amiga-ASCII-texts and
  477. only  spaces  will  be  deleted!   The  "ß"  won't be converted by the "-c"
  478. option.
  479.  
  480. If  you start Text-Wandler in Workbench-mode, a nerv-requester appears that
  481. won't be displayed in the registered version.
  482.  
  483. The  "ANSI-Remove"-  and  "Use  translation table"-mode only can be used in
  484. Workbench-Mode.
  485.  
  486. If  you  use your own table, only a length of 32 characters of the table is
  487. allowed.   All following characters won't be read.  This can cause an error
  488. message  if  you  define a sequence that is longer than 32 characters.  The
  489. following line will be read and the source-text be converted with:
  490.  
  491. "ä"="ae";"ö"="oe";"ü"="ue";
  492.  
  493. These  are  28  characters.   I think this will be enough for testing Text-
  494. Wandler !
  495.  
  496. All these restrictions are removed in the registered version!
  497.  
  498.  
  499. Shareware fee:
  500. **************
  501.  
  502. If  you  like  this program or use it regularly, please pay 10 US Dollar or
  503. any equal amount in your currency.
  504. For  registration  use the "Registration.TXT".  Print it and send it filled
  505. out  back  to  me.  If you are not able to print out the registration form,
  506. write  your address, telephone number, computer- configuration and your way
  507. of  paying  to  a  sheet  of paper and send it to the address listed in the
  508. registration  form.  For bank transfer use the bank information also listed
  509. in the registration form.
  510.  
  511.  
  512. As  a  registered  user  of  Text-Wandler,  you're then entitled to own the
  513. newest, registered version!
  514.  
  515.  
  516. Copyright information:
  517. **********************
  518.  
  519. Shareware version:
  520.  
  521.   The  Program  may  only  be  copied with this manual and the registration
  522.   form.   The  manufacturing-/copy-fee mustn't be greater than 4 US Dollar!
  523.   The package may be adapted by any PD-groups ,e.g.  FRED FISH.
  524.  
  525. Registered version:
  526.  
  527.   The  registered version mustn't be copied, rented or published or even be
  528.   put on PD-Disks to be offered other people!
  529.  
  530.  
  531.   The Req.Library is Copyright by Colin Fox and Bruce Dawson!
  532.  
  533.   The ReqTools.Library is Copyright by Nico François!
  534.  
  535.  
  536. Special Thanks:
  537. ***************
  538.  
  539.  ...   to  my  brother Roger and to his friend Sebastian Schmucker for this
  540.        translation and for correcting the documents!
  541.  
  542.  ...   to  Ralph  Babel  and  Garry  Glendown  for  helping  me, when I had
  543.        questions about programming.
  544.      
  545.  ...   to Colin Fox and Bruce Dawson for their great req.library!
  546.  
  547.  ...   to Nico François for his great ReqTools.library!
  548.  
  549.  ...   to  Commodore  for  this  great machine, because ONLY AMIGA MAKES IT
  550.        POSSIBLE !!!
  551.  
  552.  
  553. Development phases:
  554. *******************
  555.  
  556. V1.0    First version from 04/25/92
  557. V1.1    Version from 05/01/92
  558.     -supports filenames with spaces by using quotation marks
  559.     -tests, if two equal filenames are given
  560. V1.2    Version from 07/03/92
  561.     -big bug removed when converting to MS-DOS-ASCII-format
  562.     -memory-allocation-routine shifted -> shorter conversion
  563.      time
  564.     -additional routines improved
  565. V1.2a   Version from 07/06/92
  566.     -wrong USAGE-Text corrected
  567. V1.3    Version from 07/11/92
  568.     -conversion-puffer has been decreased to 16384 bytes
  569.     -further conversion bug removed; carriage returns weren't
  570.      converted correctly while translated into Amiga-ASCII-format
  571.     -additional routines improved -> very short conversion times
  572.      when converting from harddisk to harddisk
  573.     -bug that prevent a correct running under Kickstart 1.2/1.3
  574.      has been removed
  575. V1.4    Version from 07/21/92
  576.     -additional special-characters are also converted
  577. V1.5    Version from 07/24/92
  578.     -the chars "|" and "ª" were exchanged uncorrectly and, in version
  579.      1.4, corrected; very necessary if you convert c-sources!
  580.     -if you give a directory instead a filename as a destination, the
  581.      text will be converted to that directory with the source-name
  582.     -security check added on a perhaps existing destination-file
  583.     -new switch (-o) added; turns off the security check listed before;
  584.      if there exists already a file with the same destination-name,
  585.      it will be overwritten by the new one
  586.     -the text will be converted to MS-DOS-ASCII-format if there is
  587.      no switch given
  588. V1.6    Version from 08/11/92
  589.     -shorter code because of better programmed routines
  590.     -the Text-Wandler can be aborted now by pressing CTRL-C
  591.     -the program displays now the actual byte-position while
  592.      converting; the display can be turned off by using the "-n"
  593.      switch
  594.     -new routine added for deleting unused spaces and tabs at the end of
  595.      a line
  596. V1.7    Version from 08/13/92
  597.     -the first character of the source-text was ignored when
  598.      converting to Amiga-ASCII-format
  599.     -vowels are now converted to usual ASCII-characters, e.g.
  600.      "ö" to "oe"
  601. V2.0    Version from 09/12/92
  602.     -Workbench-mode added; you can control all functions via
  603.      mouse now
  604. V2.1    Version from 09/23/92
  605.     -If you convert to Amiga-ASCII-format the end of lines will be
  606.      checked for a carriage return and a linefeed
  607.     -Text-Wandler now can remove ANSI-sequences from any texts
  608. V2.2    Version from 11/22/92
  609.     -when using Text-Wandler under Kickstart 1.x, the string-
  610.      gadget didn't work correctly; removed that bug
  611.     -conversion from Amiga- to Atari-ASCII-format added
  612.     -version-string added; the version-number now can be displayed
  613.      by using the "Version" command
  614.     -the usage text will now stop being displayed after every 12
  615.      lines and will wait until the return-key is pressed
  616. V2.2a   Version from 11/30/92
  617.     -more bugs corrected
  618.      + the ANSI-remove-routine didn't work correctly
  619.      + the security check didn't read the following return-key
  620. V2.3    Version from 12/06/92
  621.     -the "STOP"-gadget had a bug; it caused a reset
  622.     -too large ANSI-sequences weren't deleted
  623. V3.0    Version from 01/15/93
  624.     -OS 2.x user interface added
  625.     -Text-Wandler can now convert texts using your own conversion
  626.      table
  627.     -string-gadget-bug when using Kickstart 1.x corrected
  628. V3.1    Version from 02/22/93
  629.     -The usage text now adapts on the height of the CLI-/Shell-
  630.      window; if it is full it will wait for a return-key
  631.     -when using the Workbench-mode, some conversion-routines
  632.      were exchanged - now corrected
  633. V3.5    Version from 03/27/94 Programlength: 23132 (english version)
  634.                          23576 (german version)
  635.     -now there is a German and an English version
  636.     -the translation table may now consist of decimal numbers
  637.      and of strings
  638.     -characters are no longer converted 1:1; definitions may
  639.      now have any length
  640. V3.5    Version from 05/21/94 Programlength: 23500 (english version)
  641.                          23948 (german version)
  642.     -The "ß" was converted to "uz" instead of "sz" - Bug fixed
  643.     -The CLI-Window is now switched into RAW-mode. This means that
  644.      only one character can be read
  645.     -If the CLI-Output is diverted to a file an existing destination
  646.      file will be overwritten by a new one. This is for use the
  647.      converter with a BBS System or else...
  648. V3.6    Version from 05/21/94 Programlength: 23500 (english version)
  649.                          23948 (german verison)
  650.     -The "ß" was converted to "us" instead of "sz" - Bug removed
  651.     -The shell window is now switched into RAW-mode for reading
  652.      single characters!
  653.     -An existing destinationfile will be overwritten if the output-
  654.      stream of text-wandler is divert into a file. Thats because
  655.      of better use in BBS-systems.
  656. V3.7    Version from 10/09/94 Programlength: 23112 (english version)
  657.                          23604 (german version)
  658.     -The table-conversion-routine is much faster now !!!
  659.     -Conversion bug removed
  660. V3.8    Version from 08/06/95 Programlength: 24244 (english version)
  661.                          24732 (german version)
  662.     -Settings will now be stored when leaving the program, and
  663.      reloaded when starting up again
  664.     -If you choosed files by the filerequester, always the last
  665.      path was used; now all three filerequesters have their own
  666.      last path
  667.     -If you don't convert with your own table, the table-gadgets
  668.      are disabled now
  669. V3.9    Version from 10/03/95 Programlength: 24424 (english version)
  670.                                              24928 (german version)
  671.     -When choosing another conversion table using WB mode the
  672.      table wasn't processed correctly - corrected now
  673.     -Registered version: When using kick 1.3 the name of the
  674.      registered person was written outside the window if the
  675.      length has exceeded
  676.     -The workbench mode has been added some more status texts
  677.     -Kick 2.x and above wb mode: If the destination file
  678.      exists a requester will be opened and a security check
  679.      well be made to the user
  680.     -Kick 2.x and above wb mode: If the destination path is
  681.      a directory a requester opens and asks the user if the
  682.      source filename should be used to be converted to the
  683.      destination
  684.     -The conversion Table will now be sorted in memory
  685.     -A decimal '0' wasn't processed correctly using in the
  686.      conversion table
  687.     -The subroutine that gets the CLI window structure caused
  688.      an error when running ENFORCER - now runs correct
  689.